(辦公室亂成一片)
貝老闆:「為什麼每頁內容長得不一樣?首頁像電商、內頁像公文,結帳頁在做詩?」小可:(抬起摺扇)「因為大家的 Prompt 風格自由發揮,AI 實習生被你們搞成多重人格。」
工程師 King:(皺眉)「我只說『幫我寫 Copy』,AI 竟然幫我附上三首俳句。」
AI 實習生:(單眼冒出『??』)「您說的真對這邊不應該用俳句...我將在為您改一版新的七言絕句。」
工程師 King:(皺眉)「等等!!不是....」
好威(電話那頭):「喂,先別吵。立刻建立『Prompt Cookbook』+『System Prompt』,再用 Git 收口。沒有規範,AI 就是自由靈魂。」
沒有規格,AI 會自動「好意加料」。Style Guide 要定三件事:語氣(例如「專業但親切,避免誇張詞」)、欄位(標題、摘要、CTA、SEO keywords 等)、格式(固定輸出 JSON 或 Markdown)。另外要列出 反例 與 禁止項(如不要自創數據、不要加入未驗證連結)。新手不懂寫,直接把範例貼給 AI:『請完全依下述 Schema 輸出,不要多欄位。』
System Prompt 讓 AI 理解角色、責任與邊界。例如:『你是一名 B2B SaaS 文案編輯,產出固定 JSON,錯誤時回傳 error 欄位。』把 語氣、品牌字彙、錯誤處理 寫死在 System Prompt,User Prompt 只放每次的素材。這能避免不同人風格飄移,也便於回溯「到底誰改了規則」。
把常見任務寫成「食譜檔案」:目的、輸入、輸出、範例、禁忌、測試樣本。小可把首頁、部落格、產品頁的文案需求各寫一份,工程師 King 只需把資料塞進指定欄位。AI 實習生出錯時,也能用 Cookbook 的 反例 快速定位偏差,避免每次都從零聊天。
建立 prompts/
目錄、分支保護、PR 模板、CODEOWNERS
。任何改動都要過 PR,並附 輸出對照截圖 與 驗收案例。這樣就能追蹤「哪次改了 System Prompt 導致語氣跑偏」。若要跨語系,開 locales/
子目錄,搭配 Schema 校驗,避免欄位遺漏。
System Prompt 範本(片段):
copy.v1.json
Schema。{"error": {"reason": "missing_fields", "fields": [..]}}
。User Prompt 片段:
產品:Coachly。受眾:ICF 教練。目標:誘導試用。語言:zh-TW。請輸出
copy.v1.json
。
精煉重點 1:沒有 Style Guide 的 Prompt,就像沒有菜單的廚房——每道菜都驚喜,但老闆先休克。
精煉重點 2:把 Prompt 當規格寫、用 Git 管版控,AI 才能穩定交付。
1)你們團隊現在的 Prompt 是自由發揮還是有 Style Guide?最常出現的「走鐘」是什麼?
2)選一個頁面(如首頁 Hero 區),把欄位列成 JSON Schema,請 AI 幫你生出 3 個範例並自評理由。
小作業 Prompt:
「請依下列品牌語氣與
copy.v1.json
Schema,針對『產品頁 CTA』產生三版文案,並以rationale
說明各版適用情境。」
repo/
prompts/
system/
brand.style.md
copy.system.md
cookbook/
homepage.copy.md
blog.copy.md
product.copy.md
schemas/
copy.v1.schema.json
locales/
zh-TW/
en-US/
.github/
PULL_REQUEST_TEMPLATE.md
CODEOWNERS
copy.v1.schema.json
(精簡版){
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://example.com/schemas/copy.v1.schema.json",
"title": "Marketing Copy v1",
"type": "object",
"required": ["locale", "page", "section", "title", "body", "cta"],
"properties": {
"locale": {"type": "string", "enum": ["zh-TW", "en-US"]},
"page": {"type": "string"},
"section": {"type": "string"},
"title": {"type": "string", "minLength": 4, "maxLength": 60},
"subtitle": {"type": "string"},
"body": {"type": "string"},
"seo_keywords": {"type": "array", "items": {"type": "string"}},
"cta": {
"type": "object",
"required": ["text", "url"],
"properties": {
"text": {"type": "string"},
"url": {"type": "string", "format": "uri"}
}
},
"rationale": {"type": "string"},
"updated_at": {"type": "string", "format": "date-time"}
},
"additionalProperties": false
}
copy.v1.schema.json
(有跑 Schema 驗證)。TODO
。CODEOWNERS
(範例)# System Prompt 與 Style Guide 需雙簽
/prompts/system/ @xiaoke @howie
# Cookbook 文檔
/prompts/cookbook/ @king @xiaoke
# Schema 需後端審
/prompts/schemas/ @king